Summary

• Add workflows and workflows-mistralai optional dependencies to pyproject.toml
• Document the PEP 420 namespace sub-package pattern in README

Changes

pyproject.toml:

[project.optional-dependencies]
workflows = ["mistralai-workflows>=2.0.0"]
workflows-mistralai = ["mistralai-workflows[mistralai]>=2.0.0"]

This enables the install matrix from the PEP 420 integration plan:

Plugin extras use flat naming to chain dependencies (mistralai[workflows-X] → mistralai-workflows[X]), since nested pip extras are not valid syntax.

README.md: Added "Namespace Sub-packages" section documenting the pattern.

TODO: Rename mistralai plugin

The current workflows plugin is named mistralai (mistralai-workflows[mistralai]), which means the full install path is mistralai[workflows-mistralai]. This is confusing — a plugin called mistralai inside the mistralai namespace. It should be renamed to something descriptive (e.g. platform, api, core). Once renamed, the extra here needs to be updated accordingly. Waiting on workflows team decision.

Validation

Built wheels from both repos and verified the PEP 420 namespace merge in a clean venv:

# Build wheels
cd client-python && uv build         # → dist/mistralai-2.0.0a1-py3-none-any.whl
cd dashboard/workflow_sdk && uv build # → dist/mistralai_workflows-2.0.0b3-*.whl

# Install into clean venv
python3.12 -m venv /tmp/test-ns
source /tmp/test-ns/bin/activate
pip install dist/mistralai-2.0.0a1-py3-none-any.whl
pip install dist/mistralai_workflows-*.whl

# Verify both imports resolve under shared namespace
python -c "from mistralai.client import Mistral; print('client OK')"        # ✓
python -c "from mistralai.workflows import workflow; print('workflows OK')"  # ✓

Both packages install under site-packages/mistralai/ with no __init__.py at the namespace level — Python merges client/ and workflows/ automatically.

Known issue

mistralai pins opentelemetry-semantic-conventions>=0.59b0,<0.60. mistralai-workflows transitively pulls in opentelemetry-semantic-conventions==0.60b1, which violates the client's <0.60 upper bound. Fix: widen the client's upper bound to <0.61. This dependency is generated by Speakeasy, so it needs to be updated in the next SDK generation or overridden manually (the file is in .genignore).